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TASK INSTALLATION 
ASFeLTL-038-90 


The materlal Included Tn thls funct|sna| 
Speclflcatlon, Including cut not | lalted 
to, [nstruction tires and oneratjng 
Speeds |[s for Information nurocses only, 
Alt sucn material Is Syuoject to chanoa 
without notice, .Concequently GEC makes 


no clafm and shal] not be [faoie for 
accuracy, 


Unless Ssecifisd otnerwlse, tne terns 


"RSX" and "RSX-14" Imply "ROXW110" 


“TASK INSTALLATION pace 2 


INTRODUCTION | 


: Vaenerwsseoawn 
¢ 


Task [nstaljation wll] cons}]st of twe tasks, The Task 
nullder will aerforn the linkIng ef the task anc opt}anally 
Install tne tasx, Instaij wili [mstal|] 4 task [nto the 
system that has deen oullt by the Tas« Buliaer, 


The Task Suilder [Ss 4n Interact{v®? MCR Furctlon that 
relocates and I inks object modules, user {i5rary‘sS ante 
Global Gommon's, TAG Tasx gulider als® allocates tne ser 
ASRES and astao|isnes the userfs privilecses, default 
orlor|ty and, default partit{ons, : 


Install ]s an mor function that enterd a task that has een 
buJit by the tas« oullaer inte tne rsatid systen, Instal | 
optionally astaolisnes ths, wser's aefault nartition and 
defau{t priority, Sa 


Task Bullalng of an RSX-1ip. Task [s the process cf cpeating 
ea contigueys Task Tmage on a disk and optienzity an entry Ta 
tne System Task Dileectorys from ralocatadia 2olject moculesd. 
‘Thase taskis can be User Pragrams, “CR Function Task!s or 
“170 Handler Task!s) 


‘Tne fojjowing Is a |Tst of the major ooerations retulraa *0 
-bul{d a task, They ara j[tsted In tre orcer jn wnter tnay 
are oerfor™eds 


1, Allocates of[sx storage for the user task with 
the task name as the fije mame ang finss a frae 
Syste Task UyJrectory antry |f tna task js te Ge 
Installed, 


2, Aljocates ASK's far Globaj Common and’ System 
Lists*, i : : 

3, neads ebyact modules and relocates generating 
a memory [naga on @ GIsk, 


4, conditionally Refecates routines from the User 
Libraty, 


5, Conditional{y Links to memory Resident LJerary 
routines, 


c f * . 
ewaeneernannwravnnawwaw 


% ig oa 
@ «» only orfy[jeciad tasks are provided access 


to List{s, Tabjes, Systen Suoroulnas: ans External 
Page, 


TASK INSTALLATION PAGE 


6, Cond{tionally fejocates. routines. from the 
Systen Library, 


(Rejocation Is [n Ts Increas{ng virtyal memory,) 


CONTROL STATMENTS 


Seguenenverenauan 


3 


Tha following Is a Geser|ptjon of the Task ®@ullder Contra] 
Statments, The Syntax Is defined In "od| flea UMF usIng the 


foljowltng conventions and definitlensé 


Angle brackets delim[t metal]ngulstic varlablesy 
Quote marks del]mIt a character strina, 
A slash (7) |nafcates alternation (92), 
NO operator Indfeates concatenation, 
Parens [ndjcate factoring, 
CARKAGE RETUSN [mplies |Ine continuation necessary 
ALTMODE Inolfes mo continuatlon nesessary 
‘$f! (ndlcates any number Pre eelness zero] Of, 
(NUL? [ndlcates the empty set, 
€8C> ty= Space ar Blank or corna 


SOIGIT> ss MAMAN AM PASH LH QM NSH HEMP TN HEM ZHOM 
CLETTER> Pye MAMZOEM ZINC Oe yyy XMS YSZ 
CNAMED> 222 C1, 61(<LETTERD/CDICITD , 

<CR> YE CAP AAGE PETURN 

CAMD> T2s ALTMMUE 

<TCD> Fhe <CRO/KAMND} 

CNBCD> 4145 Non Beoeak Character 


Insta]! Ts an MCR Function task that Insarts a teasy Into 
‘Systen Tas Q]rectaty, Thea Task jjame Is the Flie rane, 

Task wane, Qefaulh Partition, and efault osrlerity 

Specified In tha fojfowlfny syntax? 


MCH SYNTAX G35 "“ENS"SCNGTD> CSCD> <TASK NAMED €&CD 
SUEFAULT PARTITION NAME> <EO> KCEFAULT PRIGPITY> <Tt>y 
TASK NAME > bre SNAMED; 
SUEFAULT PARTITION> i353 <NAMEDY 
SORFAULT PRIORJTYS tis <DECIMAL VALUED] 


EXAMPLE} 
MCR, INS+ JOE,PAR, 490 


ths 
The 
are 


TASK INSTALLATION PACE 4 


Tne Task sullder Is an MCR Funet{on Taske tne task namas 
defau{t partitjon and dafault pelority are speclfjed [n tne 
fojlowing “CR Funetion syntax} 


MCR SYNTAX $15 "TKBNWECNECD <ECD CTASK NAME> <8CD 
SOEFAULT PARTITION NAME> <3Co CCEFAULT PRIORITY NUMAERD 


qTC>3 

CTASK NAMED pte SNABEDI 

CDEFAULT FARTITICN NAMES 345 CNAMEDG 

CDEFAULT PRICRITY NUMBERS 195 €QECINAL VALIED) 


EXAMPLE! : 
MCR, TKB JOE,PAR, 476 


TASK NAME w= ASX Task#s are [dentifled dy “ames 
that are spactfled when the Tas¥s are Instailea, 
These names apa [ncenendant of oerogra® cr Filia 
names, Task Names are the names of the tag*s 69 
pe Instajled, This will bea the name chat Is 
Insertod In the System Task Directory (ST), 


DEFAULT PARTITION w= ODafault Parptitjon Is 

memory partition In wajen thea task wfli run uni 

soec(ficaliy overridgen when tne task’s axecut 
|S reqayestec, - . 


thea 
ags 
fon 


DEFAULT PRIORITY vo Defayi{t Priortty Is <A4 
orilerity under which the Task ajtl run uni{ass 4 
partiti{an is specifles wnen the Task's axAagution 
{s resuested, 


After The Task Bulider nas validated tre “CR commang |Ine Tt 
wett whit output prompting symbols and accept respanses as 
described teloy, 

OPTIONS 

peqwaveue 


The Task Sullcer wT} lt tyne an wGPTIONSE" coromoting syspel 
and accent rasponses of ths followng syntax, 


OPTIONS t= EC SGPTICN? / <TG> DI 
<OPTIGN> saa SOFTICN SYMBOL? <TERMINATOR? 3 


peassareceuewcee 


a we WHEN PATCH IS IMPLEMENTEQ, THE TASK EUILOER 
WILL OPERATE UNDER BATCH AND NOT UNDER HOR, 


TASK JNSTALLATION PAGE 5 


~donotfon sympdal> ie motte tnmmsnszr step erneh stint 
€tepminator> it= <to> / <spacee <ortlon} 


-examojed | 
optjonsi 
optionstpt,ynm,S52.6P 


Tne option symbols have tne follow!ng nean|ngst 


JN we [nsert an entry for th{s task [ns the System 
Task Ojrectory (STO), hs : 


« 


NFew declare this task to be a task that will not 
use the floating point unit) 


pT w- A Priviledaed Task fs 4 task that nas 
Executi(ve capabi!itles,; ana Ts trusted not to 
endancer the system, 1/0 dandler Tease? s and soma 
JMCR Functjon tasx's reoulre tris orlvijeqasge [7 
order to access the POoP|]=11 External Para ana 
System Subrout|nesy OF System Tagles and Lists, 


NM == No load map prevents the foaq map fron heline 
printed as tne task Js helng 'inKed, The Task 
Bullaer program narmal ly peints tre [oat an, 


‘32 «= STze of task, ThIs ontlon eausa the size af 
the user tasx to be or{nted after It has been 
\Inked, = . 


CP we Chacinotntab|]2 task,  ThTs nptlons causes 
tre disk allecation for chackpolnting ane pormits 
the task to raqyest cnecaoo[nting, 


STACK 4REA 


Coes seteas 


Stack Soace Ts alincatea Ir. Increasing memory from virtual 
Yocaton two (virtual zera 1s always used for Directive 
status), with tne Task’s Stack Folnter set to tna maxfaum 
address +2, The Stack Area Is free “enT0Ory any need “UT he 
used exclus|valy for Stack storage, 


Tne Task sullder outputs a "STACK" aromntint symhal and 
accents a fesponse of tna foljowlng syntaxt 


STACK AREA tts (€POSITIVE DECIMAL VALUCD/NUL) <TCOi 


TASK INSTALLATION PATE 6 


If no Stack siza Is specifjed, an area ef 31 words Is 
a|locatad, 7 - 


“Examplesi 


STACK {75 
STACK} 
STACK {2 


POOL LIMIT 


vFaunsavaves 


Pool LI#Tt [s the number of Poo! Nodes trnat tay be Jr use by 
a Task at any one time, If no Fool Linl* 1s snecifles a 
defaujt noe] [init of five nodes wifi oe ajlocated, Tre 
Task Suliter outauts a "POOLE" promoting sytoo0} arg accerts 


-:@ pespense of tne fojiowina syntax} 


POOL LIMIT tis (<POSITIVE DECIMAL VALTED/NULD <TC} 


EXAMPLE} 
POOLIL®A 
POOLS 
USER LIB 
“User Lio paquests the Inout of the name of tee user tlhratve 
1? any, to oe specifies, The Task sullder will tyoe "SFR 


Lime’ and accent a User Lforary nate [n tne following 
“syntax 


RAPY NAMED /NUL) <TC> i 


USER LIS NAM 3 16 
M CNAMED} 


(<LI 
CLIBRAPY NAN 343 


ts 
=> 
EXAMPLES 


USER LISILICR 
USER Lisi 


The User Library Name Is opt}onal and |[t willl cause an 


Indicated user provided | Tbrary to be seannad (to sitisty 
unresolivyeaq global synmoo| raferences) oefora ary otnet 
}{orery Is scanned, Routines fron a User Library areé 


relocated and Inclyaed as a part of tne Task ey image, 


GLOBAL COM 


Fea wveecaunee 
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The Global. Common fs used for Inter-Task communications and 
extraeTask data storage, Instal| may ne |nszructed to map a 
“ Taskts references to elements of a named Common |nto a 
Gjoba| Common of tne Same name, wlth eltter reaawoniyv or 
- pead/wrei{te accass, The Tas« Bulicer will tyne "GLOBAL SIRI" 
-and accent Global Common namas In the following syntax! 


GLOBAL COM ste SCOMMON NAME> C47 ¢<COMMON NAMED) 
~ (KACTESS COLR> /NUL) <TC>i 

<COMMON NAME> tis “NAMED J 
CACCESS COMED yee "RON/URWYG 


EXAMPLES 
GLOBAL COMsCOMA/RA 
GLOBAL COMS 7 


Each Global Common referenced requires ane ASK for each 4K 
of storage araa, a 


NUM LUNS 


eCugewaeae' ' 


‘The recuest Nun LUY!s specifies the nunter of Luvs thet will 
he aftlocated te a task, Tne Task tulijfer wll] tyoe "MUM 
LUNSt" ana accept the Numper. of ius In tne fallowing 
syntaxt SB, 


NUM LUNS tre SOCTAL VALUED <TC>: 


EXAMPLES 
Nu“ LUNSt5 
NUM LUNS! 


DEFAULT AGSISNMENTS 


Defaujt Assi[gnments allows a Task's LUNs t2 be prpaassigned, 
Any Lu“s not asslaned wifi default to "none" (unassigned), 


Any number of Asslanmants may Se used, If.a Us Js assiaqned 
to mora than one ohysical deviceeunits tre latter 
assian™ents ara cons(dered reeassijnments, and the tact 
assignment [Ss used as tne cefauls assiqrmeat, Tre Task 
Bullder wil] type “DEFAULT ASSIGHNENTSI" and atcept the 
Gefault assiqnmants [nN the following Syntac; 
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-. DEFAULT ASSIGNME"ITS ¢45 CASSIGNMENTD I 
CASSIGUMENT>? G42 SOEVICE UNE TOME" <LUNSD4 
CDEVICS UNIT> ase SOEVICE BAMED CUMNTT NUMBER? | 

<DEVICE NAMED Es CLETTERD> CLETTERO] - 
CUNT NUMBERD fle <SUCTAL VALUED] 
€LUNS> Ge SLUND <TERNDG 
€LUND bse CJECIMAL VALUED] 
CTERMD 328 K<TOd/(<8C> <LUNS?): 


EXAMPLES 
4 eK AGL 2 
179742523 
~ TTL46 


RESTDENT SIDE 


(Saar entnwe ewe 


Resident. code definas tne file names of the object nodyjas 
that 3re to ce [inked ta form the user task [mace, These 
eooject mocyjes will bs |inked In tre orcer In wnion they are 
specified, The Task Buljider will tyoe "rpasicent cedet™ and. 
accent the rasidant code modules [n the follew|nga syntax} 


RESIMENT COVE Fie <MODULE FILE NAMES> <TCD>I 
<MODULE FILE NAMES? 345 (<MO9uULe NAME DANULD | 
MODULE NAMED [ts SHAMEDI 


GENERAL DESCRIPTION 


Bese VeENnavanneraaw eee 


Tne Task bulider Is a singie tesk that contains a  I|n«er 
whleon relocates and {inks Cojact Modules, relocates and 
Tinks references to Gisaa} Conmon, ang Links to tne Sesidant 
Reeentrant Core Li]orary, The output of this tinker wil! re 
pjacad alrectiy on an allocated area on tna spaslifled dak. 
The [Task B8ulldar nrogram wi il allocate the ASR’s and Systam 
Task Directory entry for each tasK, 


Insta{| Ts a sInale task that Instal{sa task jnto the system 
by making an entry Tn tna System Tase Strectory (STO), The 
task nust have peen nreviously oulit wy the TaaK Gullaer and 
tne flia name must be the same as the task nmaina, 


DISK ALLOGATIO| 


TASK INSTALLATION PASE 9 


Tha Task gullder aflocates and zeroes cont]qunus space on 
tne snecifled disk for the rasideant code (execluating Gloval 
Common, raeraontrant |Jorary and systan r]st‘s) of a user 
task, If tne task |s Chackoointab{e The Task Builder will 
also allocate addjtlonal space to save tne enecnpolnted tasK 
[mage,. ; ody 6 oe ; : 


ASR ALLOCATION 


fequntavawarwoee 


For al! Privileged Tasks, use of the virtual address snace 
from @6G%0% thru 177777 (ASR3"ASR7) Ts presaefined, Address 
Space 4149703"177777 ¢aSR7) 1S manoea Into tne POQC11 
Externa| Page, Address space LAZEHINW197777 (ASKS 4, 5 28 4) 
Is mapned Into the executive!s Space for access to system 
tah|as, jists, pool, and executive subrout{[nes, Address 
space 96%3%3=477777 (ASRS) [Ss usea by tha Task to aceass all. 
momory (vila runstijme. alteration of Its -comtentg), and jts 
contents are not prescribed by The Task Gullcer,. 


Tanks, and al| memory address Space of nonePrivijeged Tasks 
Ts aljocated as follows: | , 


Memoey snace I[s ajlocated for access to GLOBAL GOMMONs from 
tne ton (Start}]ng with ASR7 far nonePriviletead Tasks % AS?2 
fore Privileged flasks), One AS 1s used for gach 
GLOBAL COMMON Cjess tnan 44) usad, Aaatt]onal| ASKS are ysaa 
 fop GLOGAL COMMONS that are arrater than 4% words, 


If references to the Resident Llorary ara mace, suff ictent 
ASRS to map Into the entire |lbrary- are allocates fram tre 
-.tep down, . 


ASRs for the Task execution fincluding rout] es from a user 
and syStem mealum |tbrary) are alijocated from tne hottom un. 
A5SRIS are completely satupy fer the tas*’s exegutlo. av Te 


Task Auljder, The ecniy cnangas th7t the syste  naecs fo 
make at request time |s to set up tha wysizal tacatl|on 
oftne user code, This |s determInaa at axasution hy thre 


partition tnat Is spacifled wnen tha task Js requested, 


RELOCATION PRONENURE 


Ceanveatenesawenewan 


All| task’s wil| be relocated In pnyst[eal core oy the 
Segmentation unlt (KT11), The user cade and frez core must 
be contjauous byt Tt may oe anywhere [7 onysical| cere, The 
taski w[||- apnear to start at Incatfon 4 and axnang yrvarcs 
In Virtual memory tas specifled Tn ASA Aljocetion J), 4 user 
task may pe any size to a max|mum of S2«x, Tne Gioral Sonmen 


TASK INSTALLATION PASE 10 


and yser |[brary are Included [n the s]ze of tne task and 
may not ba contiguous In virtual or onysica| memory, 


Mamory [s aj[Jocated In the fojl{ow]ng sequence} 

If the task [s a Peivjledged Task ASR? 1s Inltallzed for the 
Externa| Page, ASR'S 6,5;,4 ara than used as necessary %o 
perpm{t access ta the system |istfs and reeantrant 1/0 
Subroutines, = ; 


Gjoba| Common Is allocated first s]nce [tfs s|ze, focatton, 
and charatterlstias are Known Sefore the Qoject modules are 
Tjnked, The Global Common joaes using the first froe, ASR 
CASR7 |f net a preiylifedged tas*), i 


After tne Gjopaj| Commen Is allocate? the ‘iser Task [s 

“inked, Tha pase of the usar task starts just above tne 
Free Core and must be ohysicaily centinuous, fhe User Tack 
and: Free Cora always start fram Virtual « (49%) ana exoand 
yowards Hn Virtual memory, 

Tne Resantrant Position Indenerdent System Llorary (FORTRAN 
LISRARY, ETC,) Is the jast segment to of linwed, It will 
“use tne remalning 4SR‘S, Tha Library wil] ave read only 

pr{vfjeages to protect |% against accidental destruction, 


~ SYSTEM TASK DIRECTORY FNTAY] 


’ 
2 ee ee el eel 


“The Task Bulider and Instaj{ wll make an entry [nm the 


“Systen Task Clrentory, This antry wlll Inciuce the TeaK 
Name, Mefault Partition, ang vefault Pefor{[tv as :sracifiea 
In tne svstern List’s Sec, The Tas Instatlattion wlt| 


Tasure that tners afe mo confiists [In Task “ames of ather 
pararaters of tna tas, ee 


